====== Random Selection for Questionnaires ======

In a survey project you can create several questionnaires (**Assemble Questionnaire**) -> **Create new Questionnaire** or **Manage Questionnaires**). If the participant opens the [[:en:survey:url|link to to questionnaire]], they can be randomly assigned to one of the questionnaires.

**Note:** For experiments it is usually much easier (!) to create only one questionnaire and vary the stimulus with a small PHP code ([[:en:create:randomization]]).


==== How-to ====

First you create an additional questionnaire under **Assemble Questionnaire** -> **Create new Questionnaire**, that takes care of the random assignment. The questionnaire identifier can be chosen freely, for the following description we use the ID "random".

Define this questionnaire as the default questionnaire under **Assemble Questionnaire** -> **Manage Questionnaires**.

{{:de:create:scr.random-questionnaire.questionnaires.png|Questionnaires for random selection}}

To ensure an equal distribution of the participants on the questionnaires, you need a question of the type [[:en:create:questions:random]]. You can create this question in any category -- for the further description it is assumed that this question has the ID "RF01".

{{:de:create:scr.random-questionnaire.random-create.png|Create random generator}}

Enter the IDs of the questionnaires (see above) you want to choose between as //codes// in the random generator and save the question ({:button.save.png|Save question}}).

Leave the default setting "equally distributes" selected for the //type of drawing//. The option "Equally distributed in finished questionnaires" will //not// work because the random distribution questionnaire will never be finished.

{{:de:create:scr.random-questionnaire.random-contents.png|Random generator for the selection of the questionnaire}}

Open the questionnaire that you have created for random distribution under **Assemble Questionnaire** for editing.

  - Drag the random generator (RF01) to the first (and only) page of the questionnaire, and
  - place the following [[:en:create:php|PHP code]] below it.

<code php>
$qnr = value('RF01', 'label');
goToQuestionnaire($qnr);
</code>

The function ''[[:en:create:functions:value]]'' retrieves the ID of the randomly drawn questionnaire from the random generator. The function [[:de:create:functions:goToQuestionnaire]] jumps directly to the questionnaire with the corresponding ID.

{{:de:create:scr.random-questionnaire.questionnaire.png|Questionnaire to randomly select a questionnaire}}

You have chosen the questionnaire "random" under **Assemble Questionnaire** -> **Administer Questionnaires** as the default questionnaire for the survey project. The participants can call [[:en:survey:url]] without further parameters (''q=...''). They will then first be taken to the "random" questionnaire and from there randomly distributed to one of the other two questionnaires.